home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / tls / tls088.hpux.ltr < prev    next >
Text File  |  1995-07-31  |  6KB  |  201 lines
  1. Note: I think there are some problems with the accompanying Visual Tcl
  2. for HP-UX.  We are investigating.  In the meantime, the file is left
  3. here for you to fiddle with if you like, but be forewarned there
  4. may be some glitches.  Sorry.  Your patience is appreciated.
  5. -dionj@sco.com   7/25/95
  6. =========================================================================
  7.  
  8. IXI Visual Tcl
  9. ==============
  10.  
  11. Welcome to IXI Visual Tcl 1.0C1 for
  12. HP-UX 9.0.1
  13.  
  14.  
  15. DESCRIPTION
  16. ===========
  17.  
  18. IXI Visual Tcl is a high-level graphical scripting language for graphical
  19. terminals. IXI Visual Tcl interprets commands and constructs graphical output
  20. using Motif, allowing the production of sophisticated graphical applications
  21. without the complexity of Motif.
  22.  
  23. IXI Visual Tcl is a multi-platform port of SCO Visual Tcl.
  24.  
  25.         
  26. INSTALLATION
  27. ============
  28.  
  29. To install IXI Visual Tcl, do the following:
  30.     
  31. 1. Choose a directory in which to install IXI Visual Tcl. The
  32.    recommended location is /opt, although you may choose a different
  33.    location if you wish. Move to this directory by typing:
  34.  
  35.       cd /opt
  36.  
  37. 2. After uncompressing, extract the software by typing the following:
  38.        
  39.     HP-UX:            tar xvf cdromdir/tls085.hpux
  40.  
  41.     GENERIC IXI VISUAL TCL DOC:
  42.         tar xvf cdromdir/tls085.ixidoc
  43.  
  44.    replacing cdromdir with the name of your mount directory. See the
  45.    IXI Premier Motif Installation & Release notes for more information.
  46.  
  47. CONFIGURATION
  48. =============
  49.  
  50. If you installed IXI Visual Tcl in the recommended location, IXI Premier Motif
  51. configures all the appropriate environment variables automatically.
  52.  
  53. If you installed IXI Visual Tcl in a different location, you should do the
  54. following to correctly configure your system, replacing tcl_dir with the 
  55. pathname of the directory in which you installed IXI Visual Tcl:
  56.  
  57. 1. Add the bin directory to your PATH environment variable by typing one 
  58.    of the following:
  59.  
  60.     Bourne shell: PATH=tcl_dir/IXIvt10s/bin:$PATH ; export PATH
  61.     C shell:      setenv PATH tcl_dir/IXIvt10s/bin:$PATH
  62.  
  63. 2. Set the VTCL_HOME environment variable by typing one of the following:
  64.  
  65.     Bourne shell: VTCL_HOME=tcl_dir/IXIvt10s/lib/vtcl ; export VTCL_HOME
  66.     C shell:      setenv VTCL_HOME tcl_dir/IXIvt10s/lib/vtcl
  67.  
  68. 3. The remaining environment variables needed by IXI Visual Tcl can now
  69.    be set automatically by typing one of the following:
  70.     
  71.     Bourne shell: . $VTCL_HOME/sh-env
  72.     C shell:      source $VTCL_HOME/csh-env
  73.  
  74. TESTING 
  75. =======
  76.  
  77. A number of test scripts are provided to test every aspect of IXI Visual Tcl.
  78. These are located in $VTCL_HOME/tests. To run a test, do the following:
  79.  
  80. 1. Move to the tests directory by typing the following:
  81.     
  82.     cd $VTCL_HOME/tests
  83.  
  84. 2. Run the test suite program by typing the following:
  85.  
  86.     vtcl Browse.tcl
  87.  
  88. 3. You are presented with a list of test scripts. To view a test script,
  89.    click on its name in the list. To run a script, click on the Execute...
  90.    button. To quit the test suite, click on the Close button.
  91.  
  92. DEMOS
  93. =====
  94.  
  95. Demonstration programs are located in $VTCL_HOME/examples. To run a 
  96. demonstration program, do the following:
  97.  
  98. 1. Move to the examples directory by typing the following:
  99.     
  100.     cd $VTCL_HOME/examples
  101.  
  102. 2. Run the appropriate program by typing
  103.  
  104.     vtcl demo_name
  105.  
  106.    replacing demo_name with the filename of the demonstration program you 
  107.    wish to run.
  108.  
  109.  
  110. DOCUMENTATION
  111. =============
  112.  
  113. Documentation is provided in HTML format for viewing with IXI
  114. Mosaic. The documentation for IXI Visual Tcl appears as an entry in
  115. your Book List.
  116.  
  117. SUPPORT
  118. =======
  119.  
  120. All problems may be reported to IXI either by using the problem report form:
  121.  
  122.     http://www.ixi.com/support/bugreport.html
  123.  
  124. or by sending email to:
  125.  
  126.     support@x.co.uk
  127.  
  128. Please note however that IXI Visual Tcl is not a supported product.
  129.  
  130. IXI Visual Tcl HOME PAGE
  131. ========================
  132.  
  133. For up-to-date, complete information on IXI Visual Tcl, refer to 
  134. the IXI Visual Tcl home page:
  135.  
  136.     http://www.ixi.com/devt/vtcl/cover.html
  137.  
  138. or SCO Visual Tcl home page:
  139.  
  140.     http://www.sco.com/Products/vtcl/vtcl.html
  141.  
  142. Visual Tcl 1.0C1 RELEASE NOTES
  143. ==============================
  144.  
  145. 1) SunOS 4.1.x and Solaris 2.x:
  146.  
  147.     * There is no character based display engine.  Please ignore
  148.       all references to CHARM, and/or character display server in
  149.       the documentation.
  150.  
  151.     * There is no Help support available, except for Help ON_VERSION.
  152.  
  153.     * The dialog box options -apply and -cancel are only available for
  154.       VtFormDialog and VtFileSelectionDialog.
  155.  
  156.     * If for any reason Visual Tcl hangs, you may need to kill the daemon
  157.       server process and restart your application. This 
  158.       also terminates all current vtcl applications connected to the 
  159.       server.  To kill the daemon server process, do the following:
  160.  
  161.       1. To discover the process ID number of the daemon, type 
  162.          one of the following:
  163.  
  164.           Solaris: ps -elf | grep xm_vtcld
  165.           SunOS:   ps -aux | grep xm_vtcld
  166.  
  167.       2. Kill the process by typing the following:
  168.  
  169.         kill -9 pid
  170.         
  171.          replacing pid with the process ID returned by step 1.
  172.  
  173.  
  174. 2) SunOS 4.1.x only:
  175.     
  176.     * SunOS limits the number of IXI Visual Tcl shells that can be
  177.       run concurrently to 5. To run more shells concurrently, you
  178.       must increase the value of FIFOCNT and rebuild the
  179.       kernel. You should install patch number 100347 before
  180.       attempting to do this.
  181.  
  182.     * Problems may occur under SunOS if you do not exit your IXI
  183.       Visual Tcl shell cleanly. The VtClose command should always be used 
  184.       to exit a shell. Do not attempt to exit a Visual Tcl
  185.       application by sending signals such as SIGKILL or SIGSTOP.
  186.  
  187.       If for some reason you must terminate a script using a 
  188.           process ID, do the following:
  189.  
  190.       1. Identify the process by typing:
  191.  
  192.         ps -aux | grep vtcl
  193.  
  194.       2. Kill the process by typing:
  195.  
  196.         kill pid
  197.  
  198.          replacing pid with the process ID returned by step 1.
  199.          Note that you should not use `kill -9', as this may
  200.              hang the IXI Visual Tcl server.
  201.